﻿assort                package:nenhum                R Documentation

Análise de interações agonísticas entre indíviduos através de gráficos e testes com simulações.

Description:

Verifica se os indivíduos escolhem seus rivais em conflitos de forma aleatória ou exercem algum tipo de escolha. Produz correlação entre o tamanho dos indivíduos vencedores dos conflitos e a assimetria em relação aos perdedores. Comparação entre a assimetria dos vencedores observada e gerada através de simulação com os dados da população. A função possuí argumento 'mean' que posibilita trabalhar com a média das observações ou com cada observação isoladamente (análise gráfica somente).

Usage:

assort(par , pop , win=NULL , sim=2000 , mean=TRUE)

Arguments:

par: Matriz ou 'data.frame'. DUAS COLUNAS com o valor dos atributos usados nas interações. Indivíduos que interagiram estão na MESMA LINHA.

pop: Vetor numérico, matriz ou 'data.frame'. Valor do atributo dos indivíduos da população. Matriz ou 'data.frame' somente com UMA COLUNA.

win: Vetor lógico. Valor 0 quando o indíviduo da coluna 2 for o vencedor e valor 1 quando o indivíduo da coluna 1 for o vencedor. NA quando o resultado do conflito não foi observado.

sim: Valor numérico. Número de simulações.

mean: TRUE ou FALSE. Quando 'mean'=TRUE as análises são feitas considerando o valor médio das observações, do contrário considera-se as observações separadamente.

Details:

Quando o argumento 'win=NULL' a função faz a média das assimetrias entre as colunas 1 e 2, uma simulação de médias de assimetria entre o mesmo número de pares que o presente no objeto de 'par'.

Quando o argumento 'win=NULL' e 'mean=FALSE' a função calcula a assimetria de cada par entre as colunas 1 e 2, uma simulação de assimetrias de 'sim' pares formados aleatóriamente com os indivíduos da população.

Quando o argumento 'win' for alimentado (ver Arguments, acima) a função calcula a média das assimetrias dos ganhadores em relação aos perdedores (ganhador - perdedor), faz simulações de médias de assimetrias sendo os pares gerados ao acaso com indivíduos da população e o resultado do conflito decidido ao acaso.

Quando o argumento 'win' for alimentado (ver Arguments, acima) e o argumento 'mean=FALSE' a função calcula a assimetria dos ganhadores de cada par em relação aos perdedores (ganhador - perdedor), faz simulações de assimetrias de ganhadores em relação a perdedores (para 'sim' pares) sendo os pares e o resultado dos conflitos gerados aleatoriamente.

OBS: Para cada simulação o sorteio é sem reposição, sorteio com reposição entre as simulações.

Value:

Quando o argumento 'win=NULL' gera um histograma com a frequência das assimetrias geradas pela simulação. A linha no histograma é a posição da média das assimetrias do objeto de 'par'. Devolve a médias das assimetrias observadas e simuladas, além de uma tabela com a probabilidade de observações menores ou maiores que a média das observações com pares feitos ao acaso.

Quando o argumento 'win=NULL' e 'mean=FALSE' gera um histograma com a frequência das assimetrias geradas pela simulação e linhas coloridas que correspondem às assimetrias dos pares observados.

Quando o argumento 'win' for alimentado (ver Arguments, acima) gera um gráfico com a correlação entre as assimetrias e o tamanho dos ganhadores, um histograma com a distribuição das médias das assimetrias dos ganhadores gerados pela simulação e a linha vertical que representa a média das assimetrias dos ganhadores observados e um boxplot com o tamanho dos perdedores e dos ganhadores. A função retorna a probabilidade de uma assimetria ser gerada ao acaso com valores menores e maiores do que a média observada.

Quando o argumento 'win' for alimentado (ver Arguments, acima) e o argumento 'mean=FALSE' gera um gráfico com a correlação entre assimetria e tamanho dos ganhadores, um histograma com a frequencia das assimetrias geradas ao acaso e linhas coloridas com os valores das assimetrias de cada observação e um boxplot com o tamanho dos ganhadores e perdedores observados.

Warning:

Se o objeto de pop não for 'matrix', 'data.frame', 'numeric' ou 'integer' a função devolve mensagem de erro.
Se 'mean' diferente de TRUE ou FALSE a função devolve mensagem de erro.
Se 'sim' maior que 20000 a função retorna mensgame de erro.

Author(s):

Caetano, Daniel Silva
Aluno de mestrado do Departamento de Ecologia, Instituto de Biociências, Universidade de São Paulo, Brasil.
caetanods1@gmail.com

References:

http://ecologia.ib.usp.br/bie5782/doku.php
http://ecologia.ib.usp.br/bie5782/doku.php?id=bie5782:01_curso2009:alunos:trabalho_final:daniel

See Also:

'for' para fazer ciclos de simulações.
'if' e 'else' para a definição de condições.
'plot', 'hist' e 'boxplot' para os gráficos.

Examples:

## Lembre-se de carregar a função antes de rodar o exemplo!

## Criando dados
total <- rnorm(700,41,11)
grupo1 <- c(35.75,45.01,47.05,47.48,47.69,49.33,50.42,50.86,52.47,53.35,53.03,57.02,57.21)
grupo2 <- c(30.45,47.33,47.69,44.89,53.03,40.98,52.68,53.79,46.62,51.87,52.15,50.45,55.48)
briga <- c(1,0,0,1,0,1,0,0,1,NA,NA,1,1)
dados <- matrix(c(grupo1,grupo2),ncol=2,nrow=length(grupo1))

## Analise de escolha:
assort(dados,total)

## Analise de escolha por interação:
assort(dados,total,mean=FALSE)

## Analise de assimetria de ganhadores:
assort(dados,total,briga)

## Analise de assimetria de ganhadores por individuo:
assort(dados,total,briga,mean=FALSE)
